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PIRATE is the Purdue Interactive Remote Access Terminal Environment 




It 




file 




and 







job submission, and macro execution facilities. It is one of the sub 
systems available to a terminal user through the PROCSY system. The reader 



is referred to PUCC document LO-PROCSY for a description 




how to log on 



to 




PROCSY system and enter 





subsystem 



This document will describe the basic PIRATE facilities which will 



enable a user t 



*.: 



> 




9 




O 







storin 

a small subset 





create 



from a terminal. 



and retrieve jobs as well as editing 



* 



and 




ii •« 




i 



•* A ** 



44 



1; 



***- 
W 





his 




discusses only 




the PIRATE facilities, it should provide enough infor 



motion to enable a user to use PIRATE effectively with a minimum 




I 




; J 4- 






ti 





If 



# 



1.1 



Command 




rom 





be pr 




on entering the PIRATE 
ted: 



subsystem, a mes 




like the following will 



PIRA 

t t i 

IT I 








*i> 






8/02/73. 





13.16 



♦ 




The 



II 





II 



is the PIRAT 




c 



• JIMII 






is ready to 
commattds are explained in this document) . 



r 

and prompt. It is typed (by PIRATE) 

(some of 



to 








Upon completion of a session at a terminal, the user must log off. 



This 



is done 




by typing the followin 




c 



•Jliilt 



and: 




LOG 










note 





local 




not saved will 




All 




obs 









batch system will complete execution (if not already com- 
pleted) and will remain in the print queue for an unspecified short period 
of 





PIRATE 







' .- 



Normally when a character is typed at a terminal, the character is also 
printed at the terminal. On terminals operating in full duplex terminal mode, 
it is possible to cause the characters typed to be transmitted to the computer 
but not printed at the terminal. To do this, one must toggle the transmission 
duplex mode from full duplex to half duplex by typing 



+++QTYPE,,HALF or 44+QTY,,H 



To then toggle the transmission duplet mode back to full duplex, one types 




QTYPE , , FULL 01 -HH-QTY , , F 



1.4 Command Syntax 



In the following sections when describing the syntax of PIRATE commands 



square brackets ([ and j) will be used to enclose optional parameters and 
separators. For example, the syntax for the DISPLAY command is 



-HhfDISPLAY, filename!, first line[,last line]] [, SUP] 



O&e should note that in this example 



* 




the file name must be given 



» 



2) the optional parameters must be preceded by a separator as denoted by 



the comma 



9 



3) a last line may be specified only if a first line is specified. 



In the illustrations below of the use of this syntax, let SAMPLE be the name 
of the file. 3 be the first line number, and 17 be* the last line number. 



WH-DISPLAY. SAMPLE 



> 



4-f+DISPLAY . SAMPLE , SUP 



» •-'***** *«-»> 



4-H-D ISPLAY . SAMPLE . 3 . SUP 



» "«"•• —■" ft 



+++DISPLAY . SAMPLE . 3 . 17 



, ^MM. U^ , ^ y 



+++DISPLAY . SAMPLE . 3 . 17 . SUP 



»•**-■•". — »-»» •*- • t 
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2. 



FORTRAN ROUTINES 



This section explains the use of the PIRATE command FORTRAN. This 



command may be used to create 



9 



correct 



(edit), and execute FORTRAN pro 



grams . 

to his terminal. 



The user may then wait for the job output to return automatically 



Genera tin 



Executin 



FORTRAN 



ram 




general form 




the command t 





and execute a FORTRAN pro 



gram is (note that user-supplied information is underlined) 



++ +FORTRAN 
HEW OR FIX? 

FILE-NAME? 



NEW 

filename 



where 



filename is a user-chosen name which will be used to identify the 
program and its data. This name may be any alphanumeric character 
string up to seven characters in length, the first of which must 
be alphabetic* 



An example of the use of this command is 



-HH -FORTRfrN 

NEW OR FIX? 

FILE-NAME? TEST 



NEW 



ENTER FORTRAN PROGRAM. 

IF YOU HAVE DATA, TYPE #EOR TO SEPARATE PROGRAM FROM DATA 

TYPE //SEND TO SEND JOB FOR EXECUTION. 



COLUMN: 




1.0000 
2 . 0000 

0000 





0000- 








prog: 

WRITE 

FOgaiATC'THIS 
READ 



MAIN ( INPUT , OUTPUT , T APE5» INPUT . TAPE 6-OUTPUT 






. 0000 

- 000(3 

7 , 0000 

8.0000 
. 0000 

10.0000 

11.0000«#EOR 
12.0000- 0.543 




FORMAT 






WRITE 



FORM AT 
STOP 

END 



E15 




13.0000»#SEND 



TEST 





ii 



WAIT FOR JOB "00516" OR TYPE CTRL 




THIS IS 




TE 





1.483293E+00 



PIRATE 




TRMNL, 



» 



ZZZ,CM4500Q,T8,P50. 



** 



FUN(S,0«0) 
CTIME 000.120 SEC* FUN MOD LEVEL 60H 

LOAD(LGO,RUNLIB) 

EXECUTE, 

cx 

STOP 



. EXIT . 

.CP 
.LINES 

.TC 



CM 



flt 




.367 SEC, NL 



10100 WORDS 



.388 SEC 



9 



10 



229 UNITS' 






4 



3 TRACKS USED (MAX) 
056 MWD-SEC. 



FL 10100 WORDS 



The line numbers in the left-most columns are generated by PIRATE and 



are uisei only for editing files. 



The #EOR 1 



3 a. 



I 



special PIRATE word which means ' end-of-record' and it 



t 



is eauivalent to the 






multi-punch on card input. 




< 




The #SEND is 






special PIRATE word which is a signal that the input 



terminated 





There 
The maximum lengtl 



prin 




t positions 
line which can 





line on the TTY and NCR terminals 
e typed in is 128 characters long 



ince the PIRATE-generated line number takes ten charact 



» 



after typing 



the 62nd charact 



oi a 



line an 



tomat 




return will 




■ 

generated 



allowing the rest of the line to be typed in. 



All output lin 



are truncated to a maximum 




72 characters and the 



t 



format control charact 




£» 



preserved on each line 



The output following the results is called th# day-file and it contains 
accounting information regarding the execution of the job. 



At 



n 



nv 



time 



after #SEND has been typed, CTRL-B may be typed to obtain 



the 'H-V immediately. If the job output had not yet started to print out 



> 



+++ FORTRAN , GET , , j ob-name 



may be u.ied to obtain the job output 






E d i t lag Directives 



There are several directives which may be used to edit lines in a file 



> 



a few of which will be 



discussed here. For a description of more of the 



editing operators, see the section on "Editing a Local File". The general 



format of 



<CL 



subset of the editing directives is: 



//OPERATOR, n,i 



PIRATE 




where: 



OPERATOR is one of the following: 

or REPLACE - replace a single line 








or INSERT 
or ADD 

or NORMAL 

or DELETE 



insert a single line 

add a block of lines 

terminate the ADD operation 

delete a single line or a block of lines 



*3 



n 



is a line number, where the decimal point is assumed to be at the right 



if not specified 



* 



It 





not 



* 



ised in the //NORMAL directive. 



X 



X 




the second argument used ii 




*AD1> and //DELETE directives: 



for 




9 



it is an increment signifying the amount to be added 



to each succ 




line numb 




until the last line has been added. 



for 





ELETE, it is a line number signifying the last of a block 



o 




lines to be 




# 



Some 




i 



tas are: 




* 



10 



or 




i 




$ 



10 



replace line number 10 




' i 





or 



#1 



$ 




* 




insert line number 3.1 



■- 4 



I - 




9 




11. 0.1 



9 



or 



#A,10. 1,0.1 



add a block of lines, beginning with 
line number 10.1, then 10.2, then 10.3 

etc. until //NORMAL is typed. 



9 



//DELETE, 11, 19 



or 



#D,11,19 



delete lines numbered 11 through 19 



Note: 



The //ADD operation must be terminated by a //NORMAL rather than a 

11 or else the operation may be only partially completed. 






An example of using an editing directive during the creation of a 

program is 




* 



0000 



t&&& 






3.0000 

4. 

5.0000 
.0000 








* 





00 




9. 

6 . 0000 



#ADD 





€* 



0000 





10. 

11. 

12 . 0000 
13,0000 



PROGRAM MAIN ( INPUT , OUTPUT 



r*ai 





TAPE6=0UTPUT) 



REED%%AD (5.1) 






FORMAT (15) 






WRITE (6,2) 






FORMAT (IX, G14. 6) 



.t 







**cAf 



n 



10 . 0*X 






PIRATE 






Vbmittin 



FORTRAN 



ram 




general form 




the command to edit (change) and resubmit a FORTRAN 



program i 




FORTRAN 



NEW OR FIX? 



FIX 



FILE-NAME? filename 



Aii example using this is 




FORTRAN 



NEW Ok FIX? FIX 



FILE-NAMEV TEST 



ii 



DO YOU WANT TO SEE LOCAL FILE "TEST"? YES 



1.00QO 

2.0000* 
3 .. 0000 

4.0000-; 

5.0000- 

6. 0*30 
7 , 0000- 



n 




PRO 



WRITE (6,1) 



MAIN ( INPUT 3 OUTPUT ,TAPE5=INPUT ,TAPE6-0UTPUT) 



i FORMAT ('THIS IS A TEST 1 ) 
READ (5 9 2) X 

FORMAT (F10.0) 




2 



iffl 



2.0 



SIN(X) 



*RITE (6,3) 






<7 




e v 





9.0000 

10.0000- 

11 . 0000-#EOR 



FORMAT (IX. E15. 6) 

STOP 
END 



i 



2.0000= 0.543 

13.0000=#EOR 
ENTER CHANGES. 



11 



PE //SEND TO SEND JOB FOR EXECUTION 




1 



Jir 



?;de t ,eie 





■*■ 



fLA.CE 8 







hmD 



i 






FORMAT (1X.F10. 8) 




lft 



• * 



*■*.■* 



\-\ 



W A t x 



^Vl f" "V. 



■I 



^ 



I i 



t - 



ir 



if 



07972" OR TYPE CTRL 







-TRMN1 



tf 



* 



ZZZ»CM4500Q,T8,P50 



ft 



** 



.FUN (3, 0*0) 



CTIME 000.121 SEC. FUN MOD LEVEL 60H 
LOAD(LGO.RONLIB) 



. EXECUTE 

,cx 

.STOP 
. EXIT . 



* fi 



,368 SEC. 



* 



NL 



10100 WORDS 




.379 SEC. 



9 



10 



229 UNITS 



LINES 

TC 

CM 





TRACKS USED (MAX) 



056 MWD-SEC. 



* 



FL 



10100 WORDS 



PIRATE 





The answer to the question n D0 YOU WANT TO SEE LOCAL FILE TEST?' 1 could 



have been either "YES" or "NO". A "NO 11 answer would have caused the display 
of the program and data to be omitted, 



Any of the editing directives could have been typed following the 



I! 




//SEND must be typed to terminate the changes and start execution 



PIRATE 




3. 



LOCAL FILE MANIPULATION 



This section explains how to create, display, edit (or change) 



delete local files. 




, and 
local file is not permanent— it vanishes when the 



terminal is logged off. It may be saved in PFILES storage, thereby making 
it permanent* 



3.1 



Crea ti ng a Local Fl le 




genera 



i 



u, 



form of the command us?.a to create a local file is 



-H-f CREATE , filename 



where 



jr filename 



?« 



is the name of the local file to be created. The name 



may contain up to seven alphanumeric characters, the first 
of which must be 




ail 



etxc 



kn example- of the use of this command is 



s-4+CREATE 'IEST2 



■».rf*'r.-a.--e-c j^M04-*J- *m *w- *-.- 




0000-T. 12345 



f 



» 




7 



CM50000,T8,P50. 



2.0000*** 
3.0000=FORTRM. 

A.OOOO-LGO 

5.0CG0«#EOR 



w 





i 




+-H- 




PROGRAM TWO (OUTPUT) 



7 . 0000= 



0000 

C000= 

0000 




ATAN(l.O) 



rr***t 



OFX 
PRINT 




(X-2.0 )*X** 2 

F0FX 




* 




FORMAT ( IX , 2 (E14 . 6 , 2X) ) 




11.0000 

12 . 0000 



STOP 




ST 



OP 



4 /hi 



t h I s 



example 



9 



the local file created is a FORTRAN job starting with 



a job card and ending with the STOP statement of a FORTRAN program. Actually 



t hi s 



example contains an error because the 




line of any FORTRAN program 



m\ 1 h t 



r ** & 



the END statement 



Later the EDIT command will be discussed in which 



a r r o r s 



Ilk* this can be corrected and this file will be used as an example. 



Notice that the jobcard contains an extra parameter at the beginning 
of the jobcard line. This parameter may be any alphanumeric string so long 
as it is there. If it is omitted, a jobcard error will result. 



Any of the Purdue MACE control cards may be used when creating a file. 



Therefore the CREATE instruction permits the terminal user to generate and 
submit all jobs that a card-deck user might submit. 
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The CREATE command only creates a local file — it does not submit the 
file for execution. To submit local files for execution, see the section 
on Transmitting a Job to the Batch System. 



During creation of a file, all of the PIRATE editing directives may 




e used. //STOP or #S must be typed at the beginning of a line to tell 
PIRATE that the file creation is to be terminated. 



PIRATE - 10a 




Local File 



The general form of the command to display a local fil 




■H+DISPLAY, filename!, first line[,last line] ][, SUP] 



where "filename"' is the name of the local file to be displayed 



"first line* 1 is the number of the first line to be displayed 

If null, the whole file will be displayed. 



last line is the number of th~. last line to be displayed. 



If null, only the . rst line will be displayed. 



» I .- ■ - vti * t 



SUP denotes that line numbers should not appear in the display 



An example of the use of this instruction is 



H4-D1SPLAY X TEST2 . SUP 







f, 12345, XYZ,CM50000,T8,P50 

FOOT RAM * 

T *'T 

#EOR 

PROGRAM TWO (OUTPUT) 

ATAN(l.O) 
FOFX « (X~2.0)*X**2 
PRINT I, X, FOFX 




* •**•> 



1 F0RMAT(1X,2(E14.6,2X)) 
STOP 



" f - f ' y* 



i~ 



Notice that: #STOP is not a line in this file. Once again the user is 
eminded that the END statement must be the last statement of any FORTRAN 



program 





t-'.dxtrae a L,ocax File 




'Hie general form of the command to edit a local file is 



H-hEDIT * filename 



where "filename" is the name of the local file to be edited. 



rh 



a number of editing directives, some of which were discussed 



in the previous section entitled "Editing Directives" in chapter 2. Bef 
we. discuss the editing directives, it is important to discuss one point. 



(10/73) PIRATE - 11 



II ^ I • II 



The PIRATE editor keeps a current line pointer which is changed 
upon successful completion of an editing operation. If, for example, 
one uses the //INSERT ,12.1 directive, upon successful completion of that 



operation the current line pointer would be set to 12.1. 



Now back to the narrative. Probably the most useful single editing 
directive has the form 



[n[,i]]= (any text) 



where n is the (first) line numhe. 

i is the line number increment for subsequent 





(any t-axt) is to be inserted . s line n. 



This directive combines the functions of the REPLACE, INSERT, and ADD 



J ~*, ^.UJ.^ , 



operators. One may note that omitting both the n and the i parameters 



*l ..- A_ 1 • II 



causes the current line to be changed. 



Let us illustrate the use of this directive. 



+++EDIT.TEST2 




fl3.5 1 0.5»MAP (PART) 



4 . 0000-LOADX (LGO , RUNLIB2 ) 



%. 5000=412= END 



#S 




The first directive requested that the text following the "=" should be 



inserted as line 3,5 and that subsequent lines be added with line number 
incremented by 0.5. The second directive (given on line 4.5) caused the 
insertion of line 12. 



The editing operators below may be used with two alternative directive 
formats. The alternative forms of the directives are 



/'0*ES*TOR[,nUir 



j 



or 



#[n Li]] OPERATOR 



vher* OPERATOR .Is one of the following: 



R or REPLACE - replace a single line 
I or INSERT - insert a single line 




or ADD - add a block of lines 

N or NORMAL - terminate the ADD operation 

D or DELETE - delete a block of lines 

P or PRINT - print a block of lines (with line n 



• l- • 








or STOP - terminate editing 



v.- 



is a line number (the decimal point is assumed to be at the right 
if not specified). It is not used with the NORMAL or STOP operators 



PIRATE - 12 




is the second argument used with ADD, DELETE, and PRINT 



with ADD, it is an increment signifying the amount to be 
added to each succeeding line number. The default value 



for i is 




with DELETE and PRINT, it is a line number indicating the 
last of a block of lines to be deleted or printed. 



fl *_ -l_r__.lt 



Note that if no line number para-^.ter is given, the current line 



is implied. 



■ ■ 

The following few examples illustrate the use of the alternate 
directive forms: 



#7.26D or #D.7.26 



#6A or #A. i 



* 



o 



#1,100? or #P, 1,100 



#12.61 or #1,12.6 



Two of the PIRATE editing operators are context-oriented; that is 



9 



they are used co find and change particular strings of characters within 



a local file. The FIND operator is used to find the first pc&tteEenee. of 
a given character string * The CHANGE operator is used 






first occurrence in the "current line" of a given character 't&tiSxtg and 
replace it with another given character string. The scanning of the file 



II _- ,_ ii tt 



nj&*«*_ r» 



starts with the line after the current line and proceeds f movtw the 
file until either the character string is found or the end &£ the file is 

reached. 



■ 

The format of the directive using the FIND operator is 



In, f',nj ]F, » string' [c6l] 



l l *"2 



or 



[n,[ ,n 2 ]]FIND, ' string' [col j 



where n, is the line number after which the scan of the file is to 

1 

start (n- may be zero). 
n.~ is the line number of the last line to be scanned. 

7 



string is the string of character to be fmind. 



ii-^— j— ^.ti 



col is the line column where the left-most character of string 

is to be found; If null, all columns of each line are scanned 



ii_,, *. u ^ in 



If the given character. 1 string is found, the current line pointer 10 set to 

■ ■ ■ 

number of the line in which it occurs and the line is printed at 





Mvfr* PttntT -t-tmt?!! 



terminal. If the character string is not found* the message NO SUCH 




is 





PIRATE - 13 

■ ■■■ ■ ■ 



#s$6ffi%m 











•« »*.. -"V »<*"" 



■I,/-' 






w 




A 





.^^M^r.':,* 



/J^-^ ; 




e /., ■ * ■ ■.■■■ o 




ctive using the 




operator is 



t 



[n]C, 'string- 1 [col]*'string 2 



t 



or 



[n] CHANGE 



t 



9 




trin 




i 





t 




tring^ 



i 



where 



n 



is the number 





the line in which the character string 





nse 







stitution) 





to be 




If not present, 



the 



it 



current 




e 



t» 




*> use 





1«# JL# wfam m #• 







the strin 






cha 




& 



; ..« 





-* 



nfl.ny «i 




which is to be changed. 




trin 





is the string of characte 






which is to replace "string. 



it 



col 







tes the 






re the left-most character of 






t 





ii 











9 



if null, the whole 



line is scanned 



• 



if 



ii 




t r in 




i 




i 





9 



the character strin 




plac 






it 




(** 






foun 




:t 



9 



the 




essa 





ii 




ii 



stringy 



it 



is substituted in 




s 



SUCH 




is typed. 



i- 




ince t\ 





* i 







operator 




on a single line, either the user must 



specify 




he 




II 



number or the current 




is used 



The 




dire 




Ye 



-y 



II 



is used to find the desired string and to set the "current line pointer. 





xample illustrates the use of the PRINT 



9 




9 



and 




,-, 





BIT 














G.QOO 
000 
00 




LOCAL 
STRATE THE 




IL 






CH 









TO 




EDITING FEATURES OF 






i 




t 









UICK 




DITOR. 
FOX 




OVER THE LAZY DOG 



• 




m 

(HP 






















GOOD 




TO CO 




TO 






0000«AID OF THEIR COUNTRY. 












PLU 










y- 






























ITING 




OF 







'-**: 















ICK 









ox 





THE LAZY DOG. 




A 













ICK 







JU 







TH 




LAZY DOG. 






i 














IBU 
















? 




in 






to di 






the local 



*■ " 






the 



&y 




ir 





ero was used to cause the 'Scan 





le 






ed i t e»* • 
character 



tart with 



The 




PIRATE 




■ " . 



..«*•* , ,- . » - 




1. 



The 




f 



» 





I 




i 

was used to 







-.*J»IH ~-.\ 



.-' 2: 



,-;lv=> : "M^jjjaicy« 






Since no line number was given in the directive, the scan 




the 




ir 



e after the current line 



ii 



Note 




the 



ii 






was 



line 




The #C 



t 



mmm 



y 




f 



t 




t 



directive caused the first occurrence of the 







with 









D. 



Since 



> 



the 



ti 



current line" was used. The #F 



i 



9 



NU 



t 



to be 
no line number was specified 
directive found the first occurrence of 
was scanned starting after the "current line" (which was line 4). Notice 











that 








ound in the word 






3.4 



Dele tin 






The general form of the command to delete a local file is 



4-H-RELEASE . filename 



> 




i ^ * 
x 









ti 





the name of the local file to be deleted. 



i 



An 







le of the use of this co 







"riHr 



















LOCAL 






• 









13.0000 



» 



#* 



u ' 










t the 








Eiv -LI 






on 






two character 




of the files. The characteristics are .format of. the file (either 




(I 














of 




file 




5 



Listing Local File Names 









this instruction is 




FILE 







IteC 









us in 






instruction is 










*■ 



i 




TIVE LOCAL FILES 






T2 




13.0000 







INDEX 





PUT 



INPUT 



*■ 
* 






*P 









LOCAL 
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. -- :.-- j^-r^^/y^;^- .-.--.-,-. - ; 
















| , «^:^:^r = v%^^j ! i^^ , v^/^ -"" - : 










/ .<. .-■.-! ■■-■ - ; p.-.-r-..-,' .ffjMj-ft 







» - 




of files, (currently 5) in an active 



= i^z<r«i~' -< 
















one time. The files are kept in a file stack which is u 










at every file reference, keeping the most-recently used file name at the top 
When space is needed for a new file, the bottom file is removed from active 



status but still remains a local file to the terminal. 



• 




The FILES command causes the names of the active local files to be 



listed followed by a FILE INDEX which lists the name and type of all files 








iated with the terminal. 





example above 



9 






:^1 



tive local file is TEST2. The file 




(of type INPUT) provides terminal communication. The file PIRMAC 















contains th 








f -. 









n 
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4. 



JOB MANIPULATION 



This section is concerned with entering jobs into the batch system and 
retrieving job output from the batch system. In order to submit a program 
for execution . it must first be a local file. 



4.1 



Transmit tin 



Job 



the Batch 



stem 




■it 

general form of the command to transmit a job to the batch system is 



+-H-XMIT, j obname, filename [ , file 



I 



.-kit.. J 



where "j obname" is a user-chosen name which will be used to identify the 



program's output 



It may be any alphanumeric character string 



first character is alphabetic. Only the first four character 
significant. Never choose a j obname the Same as any 






are 



file 



name . 



i? 



filename 11 is the name of a local file which is to belsent 



.* 



V 



batch system. 



The firfet named file must contain a 





the 




record as its first logical record. 




If line 2.0 of the first-named file contains an 
will replace the line with a password card and 



then changes line 2.0 to 



ti 



**" 



so 



thft/you 



can safely 



cards. 



If 



> 



on the other hand, an asterisk is not found 





9 



It 



control 




■ » 



vou don't have 



a password, XMIT leaves the file alone and sends it. 



The purpose of the autcfm&tic 




card * iftsJSrt'ion 



* * m 



• ■ 



* 



i 




to help users 



to protect their passwords from onlookers a$d file^snoopfcrs. It also 



allows users to keep files containing, control 



- » 




in their PFIl£$ st 




it 




passwords*, 
a good f<iea 



without having to use READ keys to profcedt 
don't have a password (you really should), 
2.0 of your control card files to contain "*if* so that* y&ur* 

wo r d 




* % v 




if ypu 
have line 



a pass 





t become general knowledge. 
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An exam 




of 



u 






CO 




nd is 



■4-H-XMIT 



JOB 



TEST 2 




MINE 



SENT 





This command only transmits a job to the batch system. It does not re 
job output 



When a job 





submitted to the batch system, a batch jobname is formed 








n- : Ji 



the specified 
pie above, if the 







to 
is lo 




user's three 




user id. 



In 







on with user id of XXX, the batch 











Jobs 







■=".= J-.fftrJl- 









ot*m of 



r ±±±:: 




c 



•inn i 





to ob 







tatus of all jobs submitted 




a us 






9 





. J- 




PIRATE 




L^, « 



r»a 







An exam 




o 




u 







s command is 




STATUS 
STATUS AT 155 31:20 
XXXMINE IS EXECUTING 
CM - 15000, TIME 

RFL (50000) 




345) 



> 




SED 



PRIORITY 

SEC 



6306 





LOCAL FILES: 






T2 




13.0000 







■H 
X 



Inclu 

*J ! J *«* If JL I 







op t ± on a 




if 



SUP 



f! 



parameter will 





e the list in 




of 







The information given in the status re 




se 





t^e j ob 






user 



i 



at 



tabl 










u 



user i 









user 





d) 



* 



y t 

The job status may 




1 




the current statu 
logged on with 




of 




f 






out 



? 



in the 





frf 



the 

that it is in the input 
quetie, in the punch queue, or not 






9 



in 





The number in 




these 




on 




first 




specx 








ntry 




u 








ob 











'-j^T*-. "-" " -i^P^r 







e Z0—Q 
line giv 
has run so 

ed. 



o 



for 



th 






* 



The priority given is the 





explanation of queue priority) . 





5 



the current job field length (CM) and 




nu 




HI* 




of 





• 



The third line displays the 












of 
















the 
In thi 




e u 






$ 



re 



the STATUS 





two jobs of the same name are 
should be used before 





any 




way 




otential job name 






avo 




by 





F: 



When a job is in the print 








te 






$* 



*,-*■■■-■ 





printer or "thrown 




it may be dis 
11 Ifiirfeed) 




.•i.- 




t the terminal or 












^ O uj> 










ayfile and job output to be planted jrt 






till 






® 



£»C 






it in the print queue so it may later (at the 



: j ■ 




O 











a line printer 



# 



L _ - 




c 



•mm 






t 



while 
s command) 



The form of the PREVIEW command is 



«4e&A s*A o 





VI 







i 





i obn a 






i 



is the name of the job as specified in the XMIT command. 






een in the example below, PREVIEW displays the job dayfile and 







i 








# 










9 



On 











© 




may not 

may 




that the job 




is also printed wi 




V£ ±* 







printing of the second dayfile by 






H ■ 







I 



t 






n it starts to print. 





PREVIEW MINE 



JOB DAYFILE: 



** 

FORTRAN . 
CTIME 000.104 SEC. FUN MOD LEVEL 60H 

LGO. 



CX 

STOP 

CP 

LINES 

TC 

CM 



• 226 SEC. 



9 



NL 



5400 WORDS 



* 



10 



.233 SEC. 

14 

3 TRACKS USED (MAX) 

.081 MWD-SEC. 



201 UNITS 



9 



FL 



5400 WORDS 



JOB OUTPUT: 





000002 

000004 

000007 

00001 

000017 

000021 



PROGRAM TWO (OUTPUT) 

ATAN(l.O) 

(X-2.0)*X**2 




FOFX 
PRINT 




f 




t 



FOFX 





FORMAT (IX, 2 (E14 . 6 , 2X) 

STOP 

END 




OPROGRAM LENGTH INCLUDING I/O BUFFERS 

001074 
OUNUSED COMPILER SPACE 

007100 




#E0R 



7.853982E-01 



7.492275E-01 



#E0R 

//EOF 
#E0R 





07/31/73. PURDUE MACE 07/22/73 




16 . 38 . 00 




I 



9 



9 



XXX,CM50000,T8,P50. 



9 



38* 




* 



** 



.226 SEC. 



NL 



5400 WORDS 



L6. 38. 00. FORTRAN. 

16-38.03. CTIME 000.104 SEC. FUN MOD LEVEL 60H 

16. 38. 04. LGO. 
16. 38. 04. CX 
16. 38* 04, STOP 

If. 38. 04. CP 

l6. 38, 04. LINES 

16. 38. 04. TC 
16. 38. 04. CM 
#E0R 



.233 SEC. 

14 



10 



201 UNITS. 




TRACKS USED (MAX) 



081 MWD-SEC. 



FL 



5400 WORDS 
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Job output 




th 





(or 




queue may be 




on a line 



printer (or punched on the card punch) by using the following command 




PRINT , j obname [ , destination 




it A 



j obname 



it 






the 




of the lob as 





in the 




command 



tt 






tination 



t 



is 










M AT,ENAD 
e output 



tt 



or 



H 




h -■;. 



m. « -s> 




tt 





n 




to 



be picked up at 




or room 760 




■& 








9 



re 






ctively* 

















of t 






co 






4Hh+ 












* 










/73 




MI 







1 1" il" 



Jo 

Hitical 




output may 






-r 




It will 
the exam 







up in room B22 in 
building or at EN AD or in room 
led under the identi 



basement 



*'% .. 









ove 



9 





cter 





the job output would be identified 

the terminal identifier characters 





purpose or e 






ct. 



* 








output includes punched cards, they may also b& obtained r, in the 

ame place as the list output. The punched card job identification 










nu 






r 



# 



it 








c 









** 





\JVf 



n the print queue which the user has PREVIEWed and does not want 

e purged 












* 





Afc* 










e line 
and to do 















is 



-H-4- 







, j obname- ] [ f j obname- 



• • # 




** 







"jo 







tt 




* " ■■*■-'■ 

denotes the XMITted j obname of the job to be purged from 














■ " 



bate 








t; 












f - 



"%fl 







a 



# 






spe 




9 
















all of the user ' s terminal 

will be purged 




.*•>.,■ 






Vi * . i * 



*■ 









VS» 
















i « 

the u 







job 



. t 










i 

queues to be 







f f 







to be logged off 
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5. 



SEMI-PERMANENT 




.--. >.B. 














t 





ent 









in 




are stored in his 
if a given file is not used within a 




15-day period, it will be automatically purged from PFILES 




*•- 



This chapter 




■ 

cribes the various PFILES functions the user may 




form from PIRATE. Further documentation may be found in PUCC document 

QO-PFILES. 



5.1 



Savin 




Local 





in PFILES 




tc 





local file may be co 





followin 








&% 

WA 



in t o 







*f* ^ 



3 



*S¥fctf 





rmanent file storage by using 






* 




9 



f ilename [ /wkey [ / r 




e 



y]J 




of 








local file to be stored 



writ 




key. 



file read key 







illustrates how local file 




is 




with 



- -.-« ?= 




SIZE 
FILE( 






ey o 




COPI 




m 



24 WORD 









» 

* 








writ 




* # 



keys ar 












hanumeric string of 




replace ,a 




> 



one must speci 




* 



o 






t 




pecify 




proper 




protection keys. They may be formed 




up to four 




in length. 






the proper write key. To retr 

key. 




a 





lie 






,ch is 









a local file. 



















* 






files must be unique within any one PFILES 
be a maximum of seven alphanumeric characters 




.& 






%££** 





n 




9 




1 





st of which must be alphabetic* 




# 






trievin 





FILES 










ve a 




in 




file 




and make it a 





ile 



t 













9 





I r key ] 
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r 




it 










tt 







■* :r-^>: 



. i~:^: 



;■■+ .'.•• i . 



i-. 1 



:*'»* 






.=*.'.! 




r i 
T','„ '..' 



La 



«:**■< 









i" ~- ■ ■* '"if 





wi 






n I 

e made a 




In 
file 6f 


















lie 



v 



^^^^sssfi^ssaPSig^* =-■■ ^:^^ ^^^ -^:^~^ 



-:- r &V: 




Ite 













.->- 



is the file read key specified when 




,' 





3*1 




in storage 








IB 



If 






terminal, 




key in the 







is incorrect 





file 



> 




will not be retrieve 

















be printe 




at 







file which is re 




by a GET command is 





the user f s PFILES storage and is made a local file — it also remains 
PFILES storage 




An 








le of t 







e of the 







is 




ET.TEST2/RRR 



■*«£juH6r> 



DO 







XLE ( 





COPIED 







piac 





new edition 





a file in PFILES storage, one simply 



















is the name of the file to be replaced 



it 





tt 





r 

the 




key specified with the initial 



storage of the 











owin 










illustrat 





thi 





TEST2/WWW 



DON 




FIL 





25 WORDS 




FILE(S) COPIED 








' SW JL * 




File 














from 




storage one uses the command 




>%* 









f 






ename [ /wkey 



where 



H^* 






% 



W 






r 



¥ T* 



I 



■$ 





the 



the name of the file to be deleted 

m * 

key specified with the initial 









of 





^^^^^^^^^^r^F" ^^^^^^^F^^^^ 









ii 





*4 






1 

i 



** 
*• i 





\ 







permanent file storage, it just 




o 














Tt 





^come a local file to the terminal 



w? 



. ; , .'r 1 - "* 












e u 








command is 



t 1 



** 



*i 



.-■*- 





PIRATE 



^^^^^ b 








:\ 't • . 
1 



: -- * , t 









6 




file 




in one 



t 













use 






jmaand 




An example of the use of th 








command is 



4-H-I 








FIL 










AT 
103 



JL3 # *33 # 3 




^7 



j 



-T- tr 





> 











/30/73 

640 




t 









f 








riini 




* 



USE CNT 
RR CNT 






FILE 




JrA\^ 







PUT 
















IDLE 



FILE 
AG 

























J 



VE 



57 









to the number of words of 



..) 



The 




each 






t 





* 






retrieval 






ETs) 



i 




in 
of PUTs 




counts (CNT 

* its 



i 







9 




in 



of days 





» 











When the 




of DAYS IDLE reaches 15 



t 



the 





* - 






automatically purged. 
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6. 











i 

This chapter describes how one may obtain further information about 






Syntax 



The 




c 



• I I I 



PIRATE 




# 



and may be used to display the proper syntax for a 
To use it, one types 



» ^ 



4-H-S 




y 



command name 



where "command name" is the name of the command whose syntax is desired 



An example of the use of the SYNTAX c 



• JIIMI 



tid is 




* 



FILE [ /W -KEY [ /R-KEY [ /ID] ]], [FILE (S) ] 






±*7- ■-= _ 5BE: 




*be u 



obtain help when in need of information 



> 



the 




command 







9 



keyword 



An example of the use of the HELP command is 
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HELP: 



f 






? 






PI 

FOR THE SYSTEM 





















D 




1 










f 













J 





Ji &ZA.JL 





SIBLE TO 








USERS OF THE SYSTE 
USER MAY GAI 
THE MATERIAL 
LI 



























JL JL & 4,^*1 

























a 





*««*«* .**'** 



«J 







MEANS WHEREBY 






ON IN 







SE 
FIL 






WILL 

















MUCH OF 
PUB 



NT 








m 



HELP 




/TYP 








/T 






*> # » 



'4. 






ft 




#** 






*« 



4: 







^ 












IMIT 








TOR 


















^ 



V "C 







- ^ 














I? 




>:v* 












T" 








\1 XI 










OF 












*!i* 







t* 



4 












**# 






















v,s 





TYPE 




rr?i 





3 * 












SCIFI 





* 




UBSEQUENT 













«? 


















(CO 










ft 
ft 



- *. 















? 




*£ 















? 


















r^:L -J 















T 

JU 



















«4 
















>> ft 








f 




f 



PRINT 



? 




*feW'^*f* 














& 






*-■& T, 






.'5. 





S 




r 





m 







51 






T 







tfrfi* 













"•^Wf 














?f 










i*^3f 






***^ 















1.0 




























,1. 




























CT 






Tiff 












H 











* 



« ', 



.• 



»4» I 













TAT 10 




















3 ■ 













T 







•*» 









SAME 






XI4JL1 















# 



- • 



> 



THE 
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Exam 





obtain examples of the use of a PIRATE command, one uses 



4-H-HELP* comman 



» 








de 






the name of 







for 




examples are 



4 

An example of the use of this to obtain examples of the use of 
the CREATE command is 



+++H 



■4T\ 








EXAMPL 









* 





ILE 




LOCAL 
JOBCA 





9 ^M 






:#ii 



FILE 




MYFILE 




FILE 




TYPE 



a. ■. 




TO 




INPUT 







IS 




US 





IS 




OT GIV 

FOR 





» 




t 



FILE 




i 



IS 




THE 




FILE 



* 





CERTAIN IN 



STRUCTIONAL DATA IS PRINTED. 








LP 




FOR FURTHER INFO 







lfc.4f 






■Z&&. J4&$$JW&t^^"& T&t&Z. - 













scr 




''^t*1#lfc : 



of the most recent chafes to the PROCSY 



an 






RAT 





ys terns 



$ 



one 





NEWS 



9 




■r 



: J-'J-J ' 



** 9 





in rever 



1 1 





\%l% 



nth 




old. 








-5 " 



rest 




may be 
the 



PIRATE 
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